===============================================================================

              MODS TO INSTALL  -  OPTIMIZATION STACK (Forge 1.20.1)

===============================================================================


  Optimization stack assembled, configured, and tuned by zebyve.

  The mod names and authors below are the original creators of each mod.
  zebyve selected and configured this specific combination; credit for the
  individual mods stays with their authors.


-------------------------------------------------------------------------------


Search these EXACT names in the CurseForge app (or on Modrinth) and download
the Forge 1.20.1 build of each. They are grouped by role. Names and authors
match the source pack one-to-one.

  Tip: searching the exact name plus author avoids picking up a same-named
  port for the wrong loader. Always confirm the file says Forge and 1.20.1.




===============================================================================

  LIBRARIES   (install these first - other mods depend on them)

===============================================================================


  Balm   -   BlayTheNinth

      Conflict prevention / future mods.


  TxniLib   -   Txni

      Needed by Better Fps, Chunk Activity Tracker, Does It Tick, and
      Dynamic Lights.


  Cupboard   -   someaddon

      Needed by Smooth Chunk Save and Better Fps.


  Oblivious Core   -   Foufakirby

      Dependency.




===============================================================================

  SERVER THREAD / TICK / MEMORY

===============================================================================


  ServerCore   -   Wesley8081

      MOST IMPORTANT. Dynamic view, sim, and mobcap scaling, plus
      spawn-chunk disable.


  ModernFix   -   embeddedt

      Broad performance patches and crash protection.


  Saturn   -   AbdElAziz333

      Memory allocation and GC reduction; removes micro-stutter.


  FerriteCore ((Neo)Forge)   -   malte0811

      Blockstate memory reduction.


  No See, No Tick   -   Askaban

      Far-entity tick skipping (multiplayer).


  Does It Tick?   -   Txni

      Entity tick optimizer with a per-entity whitelist.


  Chunk Activity Tracker   -   Txni

      Activity data for the Txni optimizers.


  Clumps   -   Jaredlll08

      Merges XP orbs to cut entity count.


  Canary   -   AbdElAziz333

      REQUIRED - but ONLY with the shipped config/canary.properties.
      Mob AI, pathfinding, entity collisions, voxel shapes, block-entity
      ticking. The only mod here optimizing runtime game logic.
      Without that config file it silently disables ServerCore's cached
      ticking-chunk list. See README section 3.


  Krypton   -   Steinborn  (Forge port)

      OPTIONAL - network stack optimization. No config, no conflicts.
      Worthwhile on a DEDICATED server; does very little in singleplayer,
      where the connection is in-memory.




===============================================================================

  CHUNK LOADING / SAVING

===============================================================================


  Chunky (Forge/NeoForge)   -   pop4959

      Terrain pregeneration.


  Server Performance - Smooth Chunk Save   -   someaddon

      Spread-out chunk saves.


  Fastload   -   StockiesLad

      Faster load and join.


  Smooth Boot (Reloaded)   -   AbdElAziz333

      Startup thread balancing.




===============================================================================

  RENDERING / FPS

===============================================================================


  Embeddium   -   FiniteReality

      Core renderer (Sodium for Forge).
      REQUIRED.


  ImmediatelyFast   -   RaphiMC

      Faster GUI, text, and item rendering.
      REQUIRED.


  Better Fps - Render Distance   -   someaddon

      Distant-chunk detail reduction.
      REQUIRED.


  Entity Culling   -   tr7zw

      Hides entities occluded by blocks or terrain.
      RECOMMENDED - safe on every pack, horror included. The earlier advice
      to disable it for horror packs was wrong and has been retracted; see
      the horror notes file, section 1.


  Oculus   -   Asek3

      Shader loader.
      OPTIONAL - only if using shaders.


  Sodium/Embeddium Dynamic Lights   -   Txni

      Handheld light (immersion).
      OPTIONAL - not performance.




===============================================================================

  DO NOT INSTALL ALONGSIDE THIS STACK

===============================================================================


  Radium / Radon

      Lithium-family forks sharing Canary's codebase. Canary is now part of
      this stack, so do not add these on top of it - pick one only.

      (Canary itself used to be listed here. It is now included, with a
      config fix that resolves the ServerCore conflict. To be accurate about
      the old wording: it never blocked ServerCore's DYNAMIC system, which
      runs on classes Canary does not touch. It blocked cache-ticking-chunks.
      See README section 3.)


  Rubidium / Magnesium / OptiFine

      All collide with Embeddium because they edit the same render classes.
      Choose Embeddium only.




===============================================================================

  AFTER INSTALLING

===============================================================================


  1.  Drop the included config/ folder into your pack's config/ (overwrite).

  2.  Launch once so everything generates and validates.

  3.  Pregenerate your world before real sessions:

          /chunky radius 1000
          /chunky start

  4.  Optional: add the G1GC JVM flags listed in README.txt.


  The actual .jar files cannot be redistributed from a CurseForge export; they
  live on CurseForge and Modrinth and are fetched by the launcher. This list is
  the fastest way to reassemble the exact stack in any pack.


===============================================================================
